home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / lbkocx11 / lbkocx11.txt next >
Text File  |  1998-05-28  |  6KB  |  124 lines
  1. =======================================================================
  2. **                        ANNOUNCEMENT                               **
  3. ** Logbook v1.1 - 32 & 16-bit ActiveX control available for download **
  4. =======================================================================
  5.  
  6. I have made available for download a new release (1.1) of my LOGBOOK
  7. ActiveX (OCX) control.
  8.  
  9. This control implements a scrolling message console with very flexible
  10. file logging and time stamping capabilities. It comes as an ActiveX
  11. control (OCX) in both 16-bit and 32-bit versions. An earlier version
  12. (1.0) is still available as a VBX for use in Visual Basic 3.
  13.  
  14. Getting the files
  15. -----------------
  16.  
  17. The most recent files can always be found on the Logbook Home Page,
  18. whose Web URL is:
  19.  
  20.     http://www.multimedia.it/andy/logbook
  21.  
  22. The author, Andy Zanna, can be contacted by E-mail at the following
  23. address:
  24.  
  25.   andy@multimedia.it
  26.  
  27.  
  28. What's new in release 1.1
  29. -------------------------
  30.  
  31. * New Methods (Start, Stop, Pause, Resume) can be used instead of the
  32.   old-style Action property. 
  33. * There is a new preferred method: Log, for logging messages to the
  34.   control, as opposed to the old LogMessage property and AddItem method.
  35. * The control now has convenient property pages for all relevant options.
  36. * It is possible to show the property page dialog at run time using the
  37.   Properties method.
  38. * It can show the severity level of a message as 1st field in the log
  39.   file (off by default for compatibiltiy with old log file format).
  40. * There are 4 flag properties for showing or turning off the different
  41.   fields of a message:  ShowLevel, ShowTime, ShowID, ShowMessage
  42. * It is now possible to specify a Separator string which is inserted
  43.   between the log fields. By default, a single space is used, but this
  44.   can be set to a TAB, a comma, or any other string for subsequent easy
  45.   manipulation of the log file.
  46. * There is now a LogToConsole property, for simmertry with LogToFile.
  47.   Note: changing LogToFile is only effective before Log is opened.
  48. * The FilePath property can now explicitely contain one DOS-style
  49.   environment variable, like %TEMP%, that is interpreted at run-time.
  50.   The full log file path used while logging can be retrieved from the
  51.   FileFullPath property.
  52. * An AutoStart property has been defined that, when True, makes the
  53.   control start a log file on the first received message. You no longer
  54.   have to explicitely start the log.
  55. * The 3-char limit in the ClientID has been eliminated. Ids can now be
  56.   as long as you like. The default client ID is now "???".
  57. * When the control is used in a different host from Visual Basic, the
  58.   Format$() syntax for TimeFormat is not longer available. In this case
  59.   the control falls back to a C-language style syntax for the time
  60.   stamps.
  61. * The control can now be shown with either a "flat" or a 3D look,
  62.   according to the setting of the Appearance property.
  63. * Finally, we have included an automatic setup for Windows 95,
  64.   NT 4 or better, as well as provisions to uninstall the software.
  65.  
  66.  
  67. More Information
  68. ----------------
  69.  
  70. The most relevant features of this control are:
  71.  
  72. - Clients write messages to the object, which time stamps and formats
  73.   them. The messages are then shown in a configurable scrolling window
  74.   and optionally logged to a file.
  75.  
  76. - Messages can have a "severity" attribute (e.g. 'debug', 'info',
  77.   'alert'). The object can filter messages whose severity is below a
  78.   certain level.
  79.  
  80. - The control can track time in several ways, such as: 'current time',
  81.   'time since log started' and 'time since last message'. A user-defined
  82.   time stamp format can also be specified.
  83.  
  84. - A path (directory) for the log file location and an explicit file name
  85.   can be specified. Optionally, the object will automatically name the
  86.   files by encoding the time of creation.
  87.  
  88. - Logging can be started, stopped, paused and resumed. Event procedures
  89.   are available for  log-a-message and status change (i.e. start, stop,
  90.   pause, error) events.
  91.  
  92. - The control can open the log file automatically and close it after a
  93.   time-out has occurred or a certain number of messages has been logged.
  94.  
  95. - The control keeps statistics of the number of messages that were
  96.   logged, ignored and lost (i.e. sent when logging was off or paused).
  97.   These counters can be dumped to the log itself, or queried as separate
  98.   read-only properties.
  99.  
  100. - Finally, the control supports DDE conversations. It can receive
  101.   messages to be logged via DDE and/or echo the logged messages to DDE
  102.   clients.
  103.  
  104. More complete documentation is contained in the help file (Logbook.hlp)
  105. you will find in the download archive.
  106.  
  107. This piece of software was never actually intended for commercial
  108. use. However, just in case, there is a shareware license mechanism
  109. built in that should convince you to register with the author before
  110. you attempt to make money out of it.
  111.  
  112. In practice, you can use it freely within Visual Basic, but if
  113. you try to distribute EXEs compiled with an unlicensed copy, it
  114. will complain loudly.
  115.  
  116. I sincerely hope that you have as much fun using this software
  117. as I had writing it.
  118.  
  119. Registrations, information queries and suggestions should be
  120. addressed by E-mail directly to:
  121.  
  122.     Andy Zanna
  123.     E-mail:     andy@multimedia.it
  124.